package com.smart.community.work.mapper;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.smart.community.work.dto.StaffQueryDTO;
import com.smart.community.work.vo.StaffVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 员工Mapper接口
 * 基于用户表和用户物业公司关联表实现员工管理
 * 
 * @author Wu.Liang
 * @since 2025-01-30
 * @version 1.0.0
 */
@Mapper
public interface StaffMapper {

    /**
     * 分页查询员工列表
     * 
     * @param page 分页参数
     * @param queryDTO 查询条件
     * @param currentUserId 当前用户ID
     * @return 员工列表
     */
    IPage<StaffVO> selectStaffPage(Page<StaffVO> page, @Param("query") StaffQueryDTO queryDTO, @Param("currentUserId") Long currentUserId);

    /**
     * 根据ID查询员工详情
     * 
     * @param staffId 员工ID
     * @param propertyCompanyId 物业公司ID（可选，用于精确查询）
     * @param currentUserId 当前用户ID
     * @return 员工详情
     */
    StaffVO selectStaffById(@Param("staffId") Long staffId, @Param("propertyCompanyId") Long propertyCompanyId, @Param("currentUserId") Long currentUserId);

    /**
     * 搜索员工
     * 
     * @param queryDTO 查询条件
     * @param currentUserId 当前用户ID
     * @return 员工列表
     */
    List<StaffVO> searchStaff(@Param("query") StaffQueryDTO queryDTO, @Param("currentUserId") Long currentUserId);

    /**
     * 根据物业公司ID数组查询员工列表
     * 
     * @param propertyCompanyIds 物业公司ID数组
     * @param currentUserId 当前用户ID
     * @return 员工列表
     */
    List<StaffVO> selectStaffByPropertyCompanyIds(@Param("propertyCompanyIds") Long[] propertyCompanyIds, @Param("currentUserId") Long currentUserId);

    /**
     * 获取用户关联的物业公司ID列表
     * 
     * @param userId 用户ID
     * @return 物业公司ID列表
     */
    List<Long> getUserPropertyCompanyIds(@Param("userId") Long userId);
}
